home *** CD-ROM | disk | FTP | other *** search
/ Windows 6-Pak - Disc 5 / Windows 6-Pak (InfoMagic) (Disc 5) (1999).ISO / JAVA-Programming-Tools / apirc-1.1.exe / README.TXT < prev   
Encoding:
Text File  |  1998-10-29  |  6.8 KB  |  174 lines
  1. Apirc v1.1 - Java (c) IRC applet
  2. --------------------------------
  3.  
  4. Apirc is a Java (c) IRC multi-threaded applet with private msg,
  5. channel, nickname control, channel list, ban windows, that allow
  6. people visiting a web site to connect to irc servers. Aprelay is
  7. an IRC relay only necessary if you want to allow people to connect
  8. to outside irc servers, because of the Java network security.
  9.  
  10. - Up to 128 simultaneous connections on the relay (P133 40Mo)
  11. - Default parameters can easily be set in the html page (servers,
  12.   channels, ..)
  13. - Advantages of the multi OS compatibility of the applet (Macintosh,
  14.   Windows, Unix)
  15. - The relay (not required to connect to your own irc server) works
  16.   on Linux, Win NT4, Win 95
  17. - Up to 5 simultaneous server connections and 10 open channels on
  18.   the user side
  19.  
  20. You must have the original compressed file :
  21.  apirc-1.1.exe     for Windows NT-95
  22.  apirc-1.1.tar.gz  for Unix/Linux
  23.  
  24. If you want to run your own irc server, this server and the http
  25. web server must reside on the same machine to avoid the Aprelay
  26. installation.
  27.  
  28. Some irc servers for Windows NT, Windows95, and Unix/Linux :
  29.  W95+NT: http://www.storer.net/ircd.html
  30.  UNIXes: ftp://ftp.funet.fi/pub/unix/irc/server/irc2.x.x.tgz
  31.  
  32. If you need to use the relay, it must be runned on the machine that
  33. houses the http server, that means you must have system access on
  34. the computer, or tell your ISP/administrator to install and run it.
  35.  
  36. If you can't do that, you may copy the html code (applet part)
  37. from http://www.id-net.fr/prgs and modify codebase as follows :
  38. codebase="http://www.id-net.fr/prgs/apirc", but you will only be
  39. able to connect on irc.id-net.fr from your homepage.
  40.  
  41. This applet was successfully tested on Netscape Windows95 3.01
  42.  & 4.03 and on IE Windows95 3.01 & 4.01.
  43. It works correctly on MSIE Macintosh 3.01 beta but some menus are
  44.  curiously disabled.
  45. It works well on Netscape Macintosh 3.01, but with a slow Java 
  46. It works well on Netscape Linux 4.04.
  47.  
  48.  
  49. Installation without Aprelay (you must have your own IRC server)
  50. ----------------------------------------------------------------
  51. This IRC server and the http web server must reside on the same
  52. machine. In your web root directory, create a subdirectory called
  53. 'apirc' and install all the Java classes (*.class) in it.
  54.  
  55. The html file should be :
  56.  
  57. <applet codebase="apirc" code=apirc.class width=240
  58.  height=150 align=center>
  59. <param name=defaultnickname value="ApircUser">
  60. <param name=server1 value="irc.yourserver.com">
  61. <param name=defaultserver value="irc.yourserver.com">
  62. <param name=port1 value="6666">
  63. <param name=port2 value="6667">
  64. <param name=port3 value="6668">
  65. <param name=port4 value="6669">
  66. <param name=port5 value="6670">
  67. <param name=defaultport value="6667">
  68. <param name=channel1 value="#Geneva">
  69. <param name=channel2 value="#France">
  70. <param name=channel3 value="#Quebec">
  71. <param name=defaultchannel value="#Geneva">
  72. </applet>
  73.  
  74. You must change some values according to your own irc server, and
  75. channel+port configuration.
  76.  
  77.  
  78. Installation with Aprelay
  79. -------------------------
  80. This allow people to connect to all IRC servers.
  81. E.g. Efnet, Undernet, Ircnet, ... IRC networks without limitations.
  82. The relay has been tested on Windows NT, Windows 95, Linux 2.0.x,
  83. and can be easily compiled on other platforms.
  84.  
  85.  
  86. If you downloaded 'apirc-1.1.exe', the binary file is available
  87. (Win95/98/NT); As it was compiled with the gcc Cygnus compiler
  88. (http://www.cygnus.com), the file cygwin[.dll] and the binary
  89. aprelay[.exe] must be placed together in the same directory, and
  90. aprelay[.exe] started.
  91.  
  92. To avoid clones (some IRCs K-line if clones), start also apidentd.
  93. You should add aprelay[.exe] (and apidentd if used) in your Startup
  94. folder to make it restarting after a reboot.
  95.  
  96.  
  97. If you downloaded 'apirc-1.1.tar.gz', you must compile it. Before that,
  98. if you do not have root access, you must '#undef CLASSIDENT'. On most
  99. Unix platforms, 'cc -o aprelay aprelay.c' or 'gcc -o aprelay aprelay.c'
  100. will work. On Sparc, try with 'gcc aprelay.c -lsocket -lnsl -lresolv
  101. -o aprelay' (not verified).
  102.  
  103. This relay is not supported, if you have problems we will try to
  104. help you, but without any garantee.
  105.  
  106. You can start it directly by typing 'aprelay', but we recommand using
  107. a newly created username to start the process: create a new user in
  108. your /etc/passwd file (not directly on some OSes, see your manuals)
  109. named 'apircuser' for instance. If you have root access, do a 'chmod
  110. u+s aprelay' under root. Then Aprelay will be called this way:
  111. '/bin/su apircuser -c /usr/marc/apirc/aprelay' (paths must be adapted).
  112.  
  113. In /etc/rc.d/rc.local or equivalent, you should add this line to make
  114. Aprelay restarting after a reboot.
  115.  
  116.  
  117.  In your web root directory, create a subdirectory called 'apirc'
  118. and install all the Java classes (*.class) in it.
  119.  
  120. The html file should be :
  121.  
  122. <applet codebase="apirc" code=apirc.class width=240
  123.  height=150 align=center>
  124. <param name=defaultnickname value="ApircUser">
  125. <param name=server1 value="irc.franet.org">
  126. <param name=server3 value="irc.efnetserver2.net">
  127. <param name=server5 value="irc.dalnetserver3.com">
  128. <param name=defaultserver value="irc.franet.org">
  129. <param name=port1 value="6666">
  130. <param name=port2 value="6667">
  131. <param name=port3 value="6668">
  132. <param name=port4 value="6669">
  133. <param name=port5 value="6670">
  134. <param name=defaultport value="6667">
  135. <param name=channel1 value="#Geneva">
  136. <param name=channel2 value="#Texas">
  137. <param name=channel3 value="#France">
  138. <param name=channel4 value="#Friendly">
  139. <param name=channel5 value="#Quebec">
  140. <param name=defaultchannel value="#Geneva">
  141. <param name=relay value="webmachine.domain.com">
  142. <param name=relayport value="8888">
  143. </applet>
  144.  
  145. The 'relay' must be the hostname (not the URL) of the computer that
  146. houses the web server (with your website) and Aprelay. E.g if your
  147. web is 'http://www9.ml.org/chat', value will be "www9.ml.org".
  148.  
  149. The 'relayport' must be 8888, except if you modify the port number in
  150. the Aprelay source file. The relay value is the exact machine name or
  151. IP number where resides Aprelay.
  152.  
  153. Downloading & demo :
  154. --------------------
  155. http://www.id-net.fr/prgs
  156.  
  157. Other demo (in french) :
  158. ------------------------
  159. http://www.franet.org
  160.  
  161. If you are from a country where french is spoken, and want to add freely your
  162. own irc server to the Franet IRC Network, please visit http://www.franet.org
  163.  
  164. Copyrights :
  165. ------------
  166. - Apirc is copyrighted P.Toilon IdNet (http://www.id-net.fr)
  167. - Java is a trademark of Sun Microsystems, Inc. (http://www.sun.com)
  168. - Windows and Microsoft Internet Explorer (MSIE) are copyrighted
  169.   Microsoft Corporation (http://www.microsoft.com)
  170. - Cygnus gcc compiler is copyrighted by Cygnus Solutions (http://www.cygnus.com)
  171. - Netscape is copyrighted by Netscape Communications Corporation
  172.   (http://www.netscape.com)
  173.  
  174.